DragType Property, SftTree Object


	SftTree.DragType Property	Softel vdm, Inc.

Defines the method that determines when a drag & drop operation starts.

Syntax

Get
	VB.NET	Type = object.DragType As SftTreeDragTypeConstants
	VB	Type = object.DragType As SftTreeDragTypeConstants
	C#.NET	SftTreeDragTypeConstants Type = object.DragType;
	VC++	enum SftTreeDragTypeConstants Type = object->DragType; enum SftTreeDragTypeConstants Type = object->GetDragType();
	C	HRESULT object->get_DragType(enum SftTreeDragTypeConstants* Type);
	Delphi	Type := object.DragType : TOleEnum;
Put
	VB.NET	object.DragType = Type As SftTreeDragTypeConstants
	VB	object.DragType = Type As SftTreeDragTypeConstants
	C#.NET	SftTreeDragTypeConstants object.DragType = Type;
	VC++	enum SftTreeDragTypeConstants object->DragType = Type; void object->PutDragType(enum SftTreeDragTypeConstants Type);
	C	HRESULT object->put_DragType(enum SftTreeDragTypeConstants Type);
	Delphi	object.DragType := Type : TOleEnum;

object

A SftTree object.

Type

Defines the method that determines when a drag & drop operation starts. When a drag & drop operation starts, the OLEStartDrag, DragStarting or AutoDragging events are generated, based on the DragMethod property settings.

Type	Value	Description
dragSftTreeNext	0	The drag & drop operation can start from a cell and is initiated once the mouse cursor leaves the current item. Before an item can be dragged, it has to be selected using the keyboard or the mouse button and the mouse button has to be released, then a drag & drop operation can be started by pressing the mouse button again.
dragSftTreeBmpNext	1	The drag & drop operation can start from a label graphic, an item graphic or a cell and is initiated once the mouse cursor leaves the current item. Before an item can be dragged, it has to be selected using the keyboard or the mouse button and the mouse button has to be released, then a drag & drop operation can be started by pressing the mouse button again.
dragSftTreePix	2	The drag & drop operation can start from a cell and is initiated once the mouse cursor is moved by a certain pixel distance. Before an item can be dragged, it has to be selected using the keyboard or the mouse button and the mouse button has to be released, then a drag & drop operation can be started by pressing the mouse button again.
dragSftTreeBmpPix	3	The drag & drop operation can start from a label graphic, an item graphic or a cell and is initiated once the mouse cursor is moved by a certain pixel distance. Before an item can be dragged, it has to be selected using the keyboard or the mouse button and the mouse button has to be released, then a drag & drop operation can be started by pressing the mouse button again.
dragSftTreeNextImm	4	The drag & drop operation can start from a cell and is initiated once the mouse cursor leaves the current item. An item can be dragged as it is selected in a single or multiple selection tree control (see Items.MultiSelect property).
dragSftTreeBmpNextImm	5	The drag & drop operation can start from a label graphic, an item graphic or a cell and is initiated once the mouse cursor leaves the current item. An item can be dragged as it is selected in a single or multiple selection tree control (see Items.MultiSelect property).
dragSftTreePixImm	6	The drag & drop operation can start from a cell and is initiated once the mouse cursor is moved by a certain pixel distance. An item can be dragged as it is selected in a single or multiple selection tree control (see Items.MultiSelect property).
dragSftTreeBmpPixImm	7	The drag & drop operation can start from a label graphic, an item graphic or a cell and is initiated once the mouse cursor is moved by a certain pixel distance. An item can be dragged as it is selected in a single or multiple selection tree control (see Items.MultiSelect property).

Comments

The DragType property defines the method that determines when a drag & drop operation starts.

The DragType property determines when the OLEStartDrag, DragStarting or AutoDragging event is generated to notify the application that a drag & drop operation has been initiated by the user.

A drag & drop operation always starts at the current location described by the Items.Current property. It is the application's responsibility to visually implement the drag & drop operation unless OLE drag & drop is used.

Depending on the Type selected, dragging can start on the cell only or also on the label graphic and the item graphic.

With some Type values, a drag & drop operation starts once the user moves the mouse cursor by a certain pixel distance. The pixel distance used is retrieved by using the Windows API GetSystemMetrics(SM_CX/Y/DRAG).